workbox-google-analytics

What is workbox-google-analytics?

The workbox-google-analytics package is a module within the Workbox suite that helps you integrate Google Analytics into your service worker. It allows you to automatically track offline Google Analytics events and send them when the user comes back online.

What are workbox-google-analytics's main functionalities?

Offline Google Analytics

This feature allows you to automatically track Google Analytics events even when the user is offline. The events are stored and sent to Google Analytics when the user comes back online.

import { initialize } from 'workbox-google-analytics';

initialize();

Custom Cache Name

You can specify a custom cache name for storing Google Analytics events. This is useful if you want to manage the cache more granularly.

import { initialize } from 'workbox-google-analytics';

initialize({
  cacheName: 'custom-google-analytics-cache'
});

Parameter Customization

This feature allows you to customize the parameters sent with each Google Analytics hit. For example, you can add a custom dimension to indicate that the hit was sent while offline.

import { initialize } from 'workbox-google-analytics';

initialize({
  parameterOverrides: {
    cd1: 'offline'
  }
});

Other packages similar to workbox-google-analytics

sw-offline-google-analytics

The sw-offline-google-analytics package is another library that helps you integrate Google Analytics with service workers. It provides similar functionality to workbox-google-analytics, such as tracking offline events and sending them when the user is back online. However, it is not part of the Workbox suite and may require more manual setup.

offline-plugin

The offline-plugin is a webpack plugin that provides offline support for web applications. It includes a feature for integrating with Google Analytics to track offline events. While it offers broader offline capabilities beyond just Google Analytics, it may be more complex to configure compared to workbox-google-analytics.

README

This module's documentation can be found at https://developers.google.com/web/tools/workbox/modules/workbox-google-analytics